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FUNCTIONAL DESCRIPTION: 


This is a require file that defines the layout 

(at compile time) of most of the internal data 
structures of the Linker. Symbol table entries are 
defined separately. 


! 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
i 
! Define the layout of and accessing macros for the 
! file descriptor blocks which forma ee Linked List in 
|! the order of specification by the user. The FDB contains 
|! an RMS gg al file name block so that the file may be | 
: opened by file id after the first time. The auxiliary 

: file mame block contains a descriptor of the resultant file 
! name string (after all logical names and defaults have been 
: applied by RMS on the first open) so that this complete name 
! may be used in error messages and the ae Note however that 
: there is also a descriptor of the name that the user 
: supplied in the command. 
BYTEBLOCKF IELDS(FDB, Names are FDBS$X_... 

LF Forward Link 


L_BLINK,4 Backward Link ; 
L-ompLsT,é, Listhead for object module descriptors 
also used to point to module name List 
W_LIBLSTLNG,2, Length of the string which is the 


module name List if this is a library 
with explicit module extraction 
File specific flags : : 
String descriptor of the user supplied filename 
The RAS auxiliary filename block 


B_FILFLGS,1, 
Q-“USRNAMDSC,8 
AL_AUXFNB,NAM$C_BLN) ; 


Define input file flags 


GLOBAL LITERAL 
'w#NOTE BIT O RESERVED - SET ALWAYS BY CLI*** 


:ee RE-USED AS Ae IN LIBRARY SEARCHES** 


LNK$S_NEWUDF = 0 : WEAK, ! A module from Library added a new undefined symbol to List 

LNK$S_LIBR =_1 : WEAK, - ! Library flag bit. 

LNK$S_LIM = 2 : WEAK ! Linkable image file flag 

LNKSS-SELSER = 3 : WEAK, i Selective search file 

LNK$S_OPTION = 4 : WEAK, ! Option fils 

LNKS$S_DEBUGER = 5 : WEAK, ! File contains the Sebupeer ‘ 

LNK$S_LIBEXTR = § WEAK, ! Explicit module extraction from library 
LNK$S_LIBSRCH = : WEAK, ! Library to be searched for undefined symbols 

LNKSM_NEWUDF = 1 “ LNKSS_NEWUDF : WEAK, 

LNKSM-LIBR = 1 * LNKSS LIBR : WEAK, ' Make the mask 

LNKSM_SELSER = 1 “* LNKSS_SELSER : WEAK, ! For selective search 

LNKSM_DEBUGER = 1 * LNKS$S_DEBUGER : WEAK, ! File contains the debugger 

LNKSM_LIBEXTR = 1 * LNKSS_LIBEXTR : WEAK, ! Explicit extraction 

LNKSM_LIBSRCH = 1 * LNKS$S_LIBSRCH : WEAK; ! Search the Library 
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GLOBAL LITERAL 
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nun 


3 PMTSC_SIZE 
i Define the Layout of 


f * 
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' Define offsets into a p-section mapping table (appended 
. to module descriptors) 


0 : WEAK, ! Pointer to p=section descriptor 

1 : WEAK, i Pointer to module contribution data block 
PMT$SL_MODCON : WEAK, ! Forward List of prematurely defined symbols 
8 : WEAK; ! Size of an entry 


an object module 


li descriptor and the accessing macros 


LITERAL 
NPSE TS=12; 
“BYTEBLOCKFIE 25 (06, 
L"ALLOC, ac 
L_MODVBN, 4 


Macros to access the 


' Initial number + pnsecte 
i Names are OMDSX_YY... 
i Lin. to next in™ tile 
Module'’s contribution to memory 
! wee NET 2 FIELDS MUST BE CONTIGUOUS 
Virtual block number part 
ae byte offset part of rfa of a Library module 


B_HIPSCT,1, : hest coats number 
“FLAGS, f : Module flag 

8 MAPLNG, |, : Length of “napping tabie 
co ! —_ Len 
| ENC iméc e field. 
| ACNPSCHAP-PATSC SIZE*NPSECTS): |! PoSection map table 


\ 
i 
i 
MACRO 


MODVBN = 0,0,22,0% 
mopBYTE = 4,6,16,08; i 


Object module flags 


GLOBAL LITERAL 
OMDSM_NOPSCT = 
OMDSM_SELSER = 

i Define the Layout of 


BYTEBLOCKFIELDS(PSC, 


! Define the layout of 


RFA of a module 


Virtual block part 
! Offset within block 


1 : SHORT WEAK ! Set until a p-section is seen 
LNKSM_SELSER : * SHORT WEAK; ' Set if selective search module 


a@ program section descriptor 


; and the accessing macros 


Names are PSCSX_YY... 
Forward Link 

Backward Link 

Contributing module ‘is 

Owned relocatable Suniel list 

Base address 

Accumulated (if con)/maximum (if ovr) Length 
Allignment of p-section base 

P-Section flags 

P-Section name length 

P-Section name 


a module's p-section contribution data 


v 
> 


ro 
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F block and macros to access it. 
“SYTEBLOCKFLELDS(MPC, ' Names are MPCS$X_Y 


! 
-NXTMPC,4, ' Forward pointer” toinety Linked List) 
L_OWNOMD ,4, : Pointer to module descriptor 
L OEE ele ° ! Offset of this contribution from base 
L-LENGT ' Length of this contribution 
& B-ALIGN, ane ! This contribution's alignment 
: Define the Layout of an image section descriptor 
|BYTEBLOCKF LELDS(1SD, ! Names are ISDSX_YY... 
. bse sine*y tingee 17 list 
| . 
W_PAGES §.2 ! Number of Ah. "te oo section 
Vv “BASVPN, $, ' Base virtual page numb 
| B-PAGFCL.1, : coe fault cluster size. 
V=FLAGS,$,” / 1 : oe ae flags 
| L“BASVBN.4, i Base virtual block number 
Site Bape 
: ) 
T"NAME , Ne yméc _MAXLNG); =! I=Sect name. 


; Define isd flags 
GLOBAL LITERAL 
1SD$M 


_GBL 
1SDSM~CRF 


= 1: WEAK, ' Global section 
= 2 : WEAK, ' Copy on reference 
ISDSM_DZRO = 4: WEAK, ! Demand zero 
ISDSM_WRT = 8 : WEAK, ! Writable - 
ISD$V_MATCHCTL = 4 : WEAK, ! Bit offset to match control field 
ISDSC_MATNEV = 0 : WEAK, ! Match never 
ISDOSC_MATALL = 1 : WEAK, ! Match were 
ISDSC_MATEQU = 2 : WEAK, ! Match equa 
ISDSC"MATLEQ = 3 : WEAK; ! Match Less or equal 


i Define the Layout of the image header's constant data 
record 


BYTEBLOCKFIELDS(HDR, ! Names are HDRSX_YY... 
-RECSIZ,2 ! Size of this record 
WIHDRBLKS,2, ! Number of header blocks 
L_TFRADR1,4, ! Transfer address 1 
L-TFRADR2,4, ! Transfer address 2 
‘ed “Linn: 3: ! Linker ident major 
W"LIDMIN,2, ! Linker ident minor 
B"NAMLNG, 1 ! Length of image name 
T “NAME. we YMsC _MAXLNG); | Image name 


; Some constants of the image header 


GLOBAL LITERAL 
HDRS$C of ftLc he BYTLIT WEAK, ' Fill character for header blocks 
HORSC_FILL i 2 EAK; i Minimum number of fill bytes per header block 
' e* MUST EQUAL WIDTH OF 1SD SIZE FIELD 


ee =e 8 8 & 8 & 
e 


a — in — — eee I 
; 


H 
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, 


i Define the Linker version array. Its content is written to image 
F header and checked by the image activator. 


GENBLOCKFIELDS(LID, ' Names are LIDS$X_YY... 
MAJOR, ! Major ident (version) 
MINOR. 25; i Minor ident (alteration) 


L EQUIPMENT CORPORATION 
ENTIAL AND PROPRIETARY 
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